package service;

import model.User;

import java.util.List;

/**
 * 用户服务接口，定义了用户相关的业务逻辑操作
 * 封装了用户的注册、查询、更新和删除等核心业务功能
 */
public interface UserService {
    /**
     * 用户注册业务方法
     * 包含业务逻辑验证，如用户名唯一性检查
     * @param user 要注册的用户对象，包含用户名、密码和邮箱信息
     * @return 注册成功返回true，失败返回false
     */
    boolean registerUser(User user);

    /**
     * 根据用户名查询用户业务方法
     * @param username 要查询的用户名
     * @return 找到的用户对象，如果不存在则返回null
     */
    User findByUsername(String username);

    /**
     * 根据用户ID查询用户业务方法
     * @param id 要查询的用户ID
     * @return 找到的用户对象，如果不存在则返回null
     */
    User findById(int id);

    /**
     * 查询所有用户业务方法
     * @return 所有用户对象的列表，如果没有用户则返回空列表
     */
    List<User> findAllUsers();

    /**
     * 更新用户信息业务方法
     * 包含业务逻辑验证，如用户存在性检查
     * @param user 包含更新后信息的用户对象，需要包含有效的用户ID
     * @return 更新成功返回true，失败返回false
     */
    boolean updateUser(User user);

    /**
     * 删除用户业务方法
     * 包含业务逻辑验证，如用户存在性检查
     * @param id 要删除的用户ID
     * @return 删除成功返回true，失败返回false
     */
    boolean deleteUser(int id);
}